Skip to content
This repository has been archived by the owner on Jan 23, 2023. It is now read-only.
/ corefx Public archive

Backup important wiki information #41774

Merged
merged 6 commits into from
Oct 21, 2019
Merged

Backup important wiki information #41774

merged 6 commits into from
Oct 21, 2019

Conversation

carlossanlop
Copy link
Member

@carlossanlop carlossanlop commented Oct 14, 2019

Fixes: https://github.com/dotnet/corefx/issues/36057

Original documents in this PR:

@carlossanlop carlossanlop added documentation Documentation bug or enhancement, does not impact product or test code area-Meta labels Oct 14, 2019
@carlossanlop carlossanlop self-assigned this Oct 14, 2019
# FreeBSD build instructions

## Disclaimer
Instructions bellow may or may not give you what you want.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

typo

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In addition to the "bellow" typo, this is also a strange disclaimer. Why have instructions if they "may or may not give you what you want?" We should be clear about why they may not provide the desired results.


```sudo pkg install cmake git icu libunwind bash python2 krb5 lttng-ust llvm60 libgit2```

some scripts may still assume /bin/bash exists. To workaround it for now do of needed:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"now do of needed"?

sudo ln -s /usr/local/bin/bash /bin/bash
```

This is certainly undesirable and it should be avoided if possible.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is undesirable?

cd ~/dotnet
curl https://dotnetcli.blob.core.windows.net/dotnet/Sdk/master/dotnet-sdk-latest-freebsd-x64.tar.gz | tar xfz -
```
if on 12.x you may also need to set `LD_PRELOAD` to `/usr/lib/libpthread.so` to avoid issue when cli freezes.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"to avoid issue" => "to avoid issues"

And what does it mean that "cli freezes"?

if on 12.x you may also need to set `LD_PRELOAD` to `/usr/lib/libpthread.so` to avoid issue when cli freezes.


As of summer 2019 this CLI is no longer good enough to build all repos. If that is your case jump to section [Updating CLI](#updating--bootstrap-cli)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"If that is your case"... what case? It's beyond that point for everyone, no?

Binary snapshot can be obtained from https://github.com/wfurt/blob as dotnet-sdk-freebsd-x64-latest.tgz

## Getting sources
master of source-build pulls in source code of specific snapshot instead of tip of master branches.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm having a hard time following these docs. I'm going to stop commenting on it.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes I see what you mean. The document needs to be rewritten.

@carlossanlop
Copy link
Member Author

carlossanlop commented Oct 15, 2019

Thanks for your comments, @stephentoub @jkotas @danmosemsft .

  • I removed the conferences file. It seems it only contains links to announcements which, as Stephen mentioned, we already post regularly on dotnet/core.
  • I removed "FreeBSD" from the title in unix-instructions.md.
  • I still think we should bring the FreeBSD 3.X instructions to corefx, since the document has been modified recently multiple times (see the commit history). The main problem is the language used to write the document, so we could ask the main editors of this document help reword it. I could also do it myself, but I would do it in a future PR. What are your thoughts?

@stephentoub
Copy link
Member

Sounds fine. Thanks.

@stephentoub stephentoub merged commit 9f5e302 into dotnet:master Oct 21, 2019
@carlossanlop carlossanlop deleted the wiki branch October 21, 2019 14:00
@karelz karelz added this to the 5.0 milestone Dec 19, 2019
picenka21 pushed a commit to picenka21/runtime that referenced this pull request Feb 18, 2022
* Backup important wiki information

* Restore original title in unix-instructions.md

* FreeBSD instructions only for 3.0

* Remove conferences.md

* update unix-instructions.md title

* Move FreeBSD link to the end of unix-instructions.md


Commit migrated from dotnet/corefx@9f5e302
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
area-Meta documentation Documentation bug or enhancement, does not impact product or test code
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants